.TH E1432_SET_DECIMATION_OVERSAMPLE 3 E1432
.SH NAME
.nf
e1432_set_decimation_oversample \- Set digital filter oversample
e1432_get_decimation_oversample \- Get digital filter oversample
.fi
.IX e1432_set_decimation_oversample(3) 3
.IX e1432_get_decimation_oversample(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_decimation_oversample(E1432ID hw, SHORTSIZ16 ID,
                                           SHORTSIZ16 oversample)
SHORTSIZ16 e1432_get_decimation_oversample(E1432ID hw, SHORTSIZ16 ID,
                                           SHORTSIZ16 *oversample)
.cE
.SH DESCRIPTION

\fIe1432_set_decimation_oversample\fR specifies whether the digital
filters of a set of channels should produce oversampled output.

\fIe1432_get_decimation_oversample\fR returns the current status of
the filter oversample, of a single channel or group of channels
\fIID\fR, into a memory location pointed to by \fIoversample\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.

\fIoversample\fR selects whether the digital filters should produce
oversampled output.  \fBE1432_DECIMATION_OVERSAMPLE_OFF\fR specifies
non-oversampled output, which is what is normally desired.
\fBE1432_DECIMATION_OVERSAMPLE_ON\fR specifies output that is
oversampled by a factor of two.  This oversampling is only possible if
the span is less than the top span for the current clock frequency.

\fBNote:\fR On an E1432, when operating in multi-pass mode and
oversampled mode, the top span is limited to 10kHz and the number of
channels is limited to eight.  At spans below 10kHz the full 16
channels can be used.
.SH "RESET VALUE"
After a reset, \fIoversample\fR is set to
\fBE1432_DECIMATION_OVERSAMPLE_OFF\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_decimation_output, e1432_set_span, e1432_set_clock_freq
.ad
